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Preface to the Second Edition 


The Jet Propulsion Laboratory (JPL) publishes reports for external distribution 
describing the work that is performed by the Laboratory in such areas as 
unmanned space exploration, energy, medical engineering, and transportation. 

Since March 1976, when the first edition of The Levels of Edit was published, 
the booklet has been used by publications people at JPL and by others in the field 
of technical communication. During this time, changes .have inevitably come 
about. Although the levels-of-edit concept remains basically the same so far as 
our practice is concerned, the changes have made the original edition of the 
booklet obsolete in several details. These details reflect developments in JPL 
usage and thus should not have any real effect on users of the booklet outside the 
Laboratory. 

One of the most significant changes in this second edition is reflected in Table 
1, where a Language Edit has now been included in Level 2. After more than 
three years of experience with the original classifications, it has become apparent 
to us that Language Edit is more closely associated with Mechanical Style than 
with Substantive Edit: a Language Edit is often required when a Substantive Edit 
is not. But this does not mean to imply that a Language Edit is a mechanical 
process; on the contrary, it is as flexible, as variable, as creative as the language 
itself. Indeed, of all the editorial activities described here, the Language Edit 
poses some of the greatest challenges to the technical editor. 

During this period, the nomenclature of Laboratory publications was also 
changed: the categories of Technical Report and Technical Memorandum were 
eliminated in favor of a product called a JPL Publication. This required several 
text modifications in The Levels of Edit and the deletion of a table. 

A few additions and clarifications have been made in several of the types of 
edit, and in this edition the types as a group have been removed from their former 
Appendix position and integrated into the body of the discussion. Some 
additional examples of the distinction between format and style have been 
included in this edition. 

We have also received many interesting and helpful comments from users of 
The Levels of Edit. One of the comments received after publication of the first 
edition was a question concerning the need for such a fine distinction between 
format and mechanical style. After all, what difference does it really make 
whether a particular instance of capitalization, say, is called format or style ? The 
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answer is that such distinctions are wh*: make the levels-of-edit concept work, at 
least for us. If an editor is required to do a Format Edit, but not a Mechanical 
Style Edit (as often happens), the editor must know exactly what to do and what 
to leave undone. The Mechanical Style Edit lifts the effort into another level of 
edit (from Level 3 to Level 2) and could increase the cost. If the job is estimated 
on the basis of a Level 3 edit, the editor may overrun the estimate — with no 
justification — if he or she does not know the precise limits of the effort required. 

The first edition elicited several comments about the use of the word * ‘edit’ ’ as 
a noun. The latest edition of Webster's New Collegiate Dictionary defines the 
noun “edit” as “an instance of editing,” and this is the sense in which we use 
the term. Since The Levels of Edit is an attempt to quantify the editing process, 
the noun is used in order to denote this quantification. 

As a result of the inquiries and correspondence following the publication of the 
first edition, we have concluded that the same kinds of editorial problems exist 
wherever there is a publications department, and that editors and other publica- 
tions people are looking for the same answers throughout the industry. We don’t 
think that The Levels of Edit provides the answers to all or even most of these 
problems. We do hope, however, that it makes a contribution, especially in 
fostering the use of a standard nomenclature. The word “edit,” for example, is 
as confusing in general usage as the world “style,” and both are used 
indiscriminately to mean many different things. If publications people could talk 
to each other in a common language, perhaps some of our problems would 
disappear. 


R.V.B. 

M.F.B. 
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Abstract 


The editorial process is analyzed, and five levels of edit are identified. These 
levels represent cumulative combinations of nine types of edit: Coordination, 
Policy, Integrity, Screening, Copy Clarification, Format, Mechanical Style, 
Language, and Substantive. The levels and types of edit, although developed for 
specific use with external reports at the Jet Propulsion Laboratory, cover the 
general range of technical editing, especially as it applies to an in-house technical 
publications organization. Each type of edit is set forth in terms of groups of 
actions to be performed by the editor. 

The edit-level concept has enhanced understanding and communication among 
editors, authors, and publications managers concerning the specific editorial 
work to be done on each manuscript. It has also proved useful as a management 
tool for estimating and monitoring cost. 
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I. Introduction 


This report discusses some .specie of ihe adilorial process fton, the utopd- 
of technical editing. By ■Kctuiical editing" we mean here the editing of 
manuscripts lhat are written about scientific or engineenng subjecB. particularly 
as it is performed in an in-house technical publications organization. 

Technical editing is a rather inconsistently defined endeavor: every organza- 
tion imposes its own pragmatic requirements on the technical editor. Pro y 
the mairucharacteristic of the editorial process is the fact that ^ q ^ ° J h 
effort-the depth to which it is performed-is contingent on other pnonties such 

as time and money. 

The technical editing process is often thought of as a “manuscript polishing" 
job— the cosmetic finish to a manufactured product, the final stage ‘" the Process 
of fabrication. To many an author, the editor is someone who fixes up the 
grammar.” To others, the editor is one who, for all his good intentions, may 

only disrori the carefully commrered rechmcU message. 
the editor is a watchdog who guards the published image of the firm to others, , he 
is there merely to provide a service to the author. The real scope ° c 
editing function, however, is not so easily dismissed; tor, as this repo wi 
show 8 technical editing involves a wide-ranging, deeply probing, thorough 
review S^a technical manuscript and is performed for the purpose of improving 
the communication of scientific and engineenng concepts. In ° * 

consider the technical editor to be one who can be reliedupon to transform 
mass of rough draft material into a polished and publishable report. 
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One of the difficulties of technical editing, and at the same time one of the 
accomplishments, is the fact that it must deal with a tremendous variety of 
technical information. Certainly the technical editor cannot be expected to be an 
expert in physics, chemistry, electronics, and mathematics; yet he may work on 
manuscripts in all of these disciplines. Nevertheless, with a knowledge of the 
mechanics of writing and publishing, by the use of a great deal of logic mixed 
with some common sense, and with a certain amount of “editorial acumen,” he 
can enhance a technical manuscript to the benefit of both author and reader. 

What, then, does an editor do? How does an organization tell an editor what 
his functions and responsibilities are, and what can an author expect when he 
turns in a manuscript? How much should a technical edit cost? How much time 
should it take? 

This report describes an effort to answer these questions by analyzing the 
editorial process and imposing upon it a sense of organization and rationality. 
Experience at JPL thus far indicates that the result of this effort— the levels-of- 
edit concept — benefits author, editor, and manager alike. 

The application of this concept has, first of all, improved communication 
among those who must talk about technical editing. The manager can tell the 
editor more precisely what he is expected to do under various conditions. The 
editor can tell the author what will be, or can be, done to his work, giving the 
author options that are clearly defined and understandable. Second, it has taken 
the cost of editing out of the realm of enraged surprise and put it within the scope 
of estimation and accountability. The editor can now define a detailed scope of 
work and, having done so, can spotlight, and bring to the author’s attention, 
changes to that scope which will affect the cost. More than this, the editor can 
offer to the author a choice of costs, based on a choice of edits. Third, the 
organization can develop a hierarchy of publications products based upon the 
various levels of edit, or it can describe different editorial efforts to be applied on 
the basis of whatever parameters it chooses. Fourth, discussions about schedules 
can be kept objective by being related to the specific editorial effort involved, 
and trade-offs can be considered in exactly the same manner as for an 
engineering design. Fifth, the levels of edit provide an ideal instrument for 
training new editors and for appraising editorial performance, since the editor’s 
duties are specified in concrete terms. Finally, an author can use the levels of edit 
to obtain a given level of quality at a lower cost and in a shorter turnaround time 
by performing some of the editorial functions himself in preparing the manuscript. 

It is the position of the Jet Propulsion Laboratory that its publications will 
receive the most thorough edit possible, and that the only reasons for applying 
less than a thorough edit are the practical constraints of time and money. The 
levels-of-edit concept makes it possible to back away from the full treatment in 
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an orderly fashion, so that a publication will still receive the highest level of edit 
consistent with the time and money constraints imposed upon it. 

The following sections describe the levels-of-edit concept and tell how the edit 
levels are constructed. They also contain brief discussions about the manuscripts 
that are submitted to an editor and about some elements of format and style. The 
last section contains a detailed description of the different types of edit that may 
be performed on any one publication. Wherever possible, the rationale for 
making specific assumptions or decisions has been presented as well, so that 
readers in other organizations may modify the approach to fit their own needs. 
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II. The Levels-of-Edit Concept 


To analyze the editorial process at JPL, as many as possible of the editonal 
functions perfonned at the Laboratory were listed and grouped into nine basic 
categories. These categories, which we call ‘‘types’’ of edit, are different jnough 
from each other to stand alone as separate and distinct applications of the 
editorial process. The nine types of edit are 


(1) Coordination 

(2) Policy 

(3) Integrity 

(4) Screening 

(5) Copy Clarification 

(6) Format 

(7) Mechanical Style 


(8) Language 

(9) Substantive 
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Each of these types of edit consists of a number of specific editorial functions 
(see Section VI). Five cumulative combinations of the types of edit, as 
performed at JPL, have been identified as levels of edit (Table 1). 


Table 1. Types and levels of edit 


Type 


Level of edit 



1 

2 

3 

4 

5 

Coordination 

X 

X 

X 

X 

X 

Policy 

X 

X 

X 

X 

X 

Integrity 

X 

X 

X 

X 


Screening 

X 

X 

X 

X 


Copy Clarification 

X 

X 

X 



Format 

X 

X 

X 



Mechanical Style 

X 

X 




Language 

X 

X 




Substantive 

X 






At JPL, the external institutional publications are divided into classes that 
designate, in general, the level of their physical quality and appearance. A Class 
A publication is usually typeset, with justified columns, the artwork is inte- 
grated with the text, and the publication is printed and bound using high-quality 
materials and techniques. The format of Class A publications is institutionally 

determined. 

A Class B publication is usually typewritten, with unjustified columns, the 
illustrations and text appear on separate pages, and the publication is pnnted and 
bound using more economical materials and techniques. The format of Class B 
publications is also institutionally determined. 

Class A and B publications are received by the editor in manuscript form and 
are composed by publications personnel. 

A Class C publication is not composed by publications personnel but is 
processed by them as camera-ready or nearly camera-ready copy. Format con- 
siderations are relaxed in Class C publications. 
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As indicated in the descriptions above, JPL is also involved in a variety of 
composition methods. These methods include conventional hot-lead typesetting, 
computer-assisted typesetting (photocomposition), computer-assisted manuscript 
processing, and typewriter composition. 

The variety of both the classes of publications and the methods of composition 
was an influential factor in determining the kind and number of levels of edit 
suitable to the Laboratory’s publication requirements. These considerations are 
evident in the following brief description of how the levels are applied at JPL. 

In a Level 5 edit, the editor verifies that JPL policy has not been violated, 
routes the manuscript through the various production processes, and perijrms a 
liaison function between the authoi and publications personnel. The Level 4 edit 
applies mainly to publications produced from camera-ready copy submitted by 
the author, and ensures that the material meets the minimum requirements for a 
JPL publication. On the other hand, if the material is not camera-ready, it will 
have to go through a composition process, and the editor, performing a Level 3 
edit, will be required to clarify the copy for the compositor and to indicate the 
format. The Level 2 edit is often used for such publications as journal articles and 
meeting papers, where a specific mechanical style is required by the publisher. 
And in a Level 1 edit, the full range of editorial capabilities is applied to produce 
a first-class publication. 

The types of edit listed in Table 1 may be used independently, or in some 
combination of the types of edit that does not fit one of the edit levels; for 
example, an author may require an Integrity Edit and a Language EdSt and 
nothing more. In ^uch a case, the two typ^s of edit would be performed without 
reference to the levels of edit. But this approach is valid only for those 
manuscripts that do not have an institutionally imposed minimum level of edit; 
e.g., manuscripts that are being edited for review or management approval or for 
the open literature. Otherwise the institutional requirement concerning the 
appropriate level of edit would govern. 

There is, however, a definite advantage in combining the types of edit into 
various levels, since the levels relate to the kinds of products published, the 
quality of those products, and the cost. 
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III. Extraordinary Editorial Functions 

For one reason or another, each of the editorial functions listed below requires 
more time and effort than is normally expended in editorial processing at JPL. 
These functions are not considered part of a normal edit and therefore are not 
included in the types of edit discussed in Section VI. They are also not included 
in a normal estimate; if it is known in advance that any of these functions will be 
required, the original estimate is adjusted accordingly. If, on the other hand, 
such a need develops as the editorial work is in progress, the additional effort 
may indicate a change in scope that should be reflected in a revised estimate. 

Extraordinary editorial functions include the following: 


(1) Providing additional or missing material. 

(a) Researching references, if more than a minor effort is involved. 

(b) Writing, other than minor or occasional passages. 

(c) Locating missing items such as figures. 

(d) Collecting data or examples of previous publications to provide 
authors with material for decision-making. 

(2) Working with unusually difficult or time-consuming material. 

(a) Editing copy written in a foreign language. 
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(b) Editing copy written by a foreign-bom person who is not familiar with 
idiomatic English usage. 

(c) Editing transcribed tapes. 

(d) Editing handwritten manuscripts, particularly those containing 
mathematics. 

(3) Performing repeated operations on material. 

(a) Handling multiple iterations of a manuscript. 

(b) Incorporating more than one series of author changes to a manuscript 
or to any element, such as a table or figure, if more than a minor effort 
is involved. 

(4) Editing for technical content. 

(a) Combining two or more manuscripts on the basis of technical content. 

(b) Reducing the length of a manuscript on the basis of technical content. 

(c) Verifying the accuracy of technical data. 

(d) Calculating International System (SI) unit conversions from cus- 
tomary or English units. 

(e) Identifying and correcting inconsistent use of mathematical symbols. 

(5) Performing unusually time-consuming services. 

(a) Dealing directly with more than one author. 

(b) Handling incremental input. 

(c) Dealing with out-of-town authors. 

(d) Making trips away from JPL for the purpose of 

(i) Making pickups or deliveries. 

(ii) Conducting author reviews. 

(iii) Performing quality control checks on vendors’ premises. 


IV. The Condition of the Manuscript 

One of the most influential factors affecting the time and cost of the editorial 
effort is the condition of the manuscript. We mean here not so much the physical 
condition, although that obviously has an effect, but the quality of the content. 
Consider two manuscripts, both clean and neatly typewritten. The first is well 
prepared and requires very few blue-pencil marks by the editor. The second is 
poorly prepared, and nearly every line contains some editorial changes. Let us 
further assume that the editor has performed a Level 1 edit in each case. 

Although the editor has performed the same level of edit in both cases, he has 
spent far less time on the well prepared manuscript than he has on the poor one. It 
is apparent that the level of edit alone does not determine the level of effort 
requited. In fact, for any given level of edit, the condition of the manuscript has a 
decisive effect on cost and schedule. 

The quality of the manuscript, then, is fully as important as the cost and sche- 
dule constraints and the specified level of edit in determining the amount of 
editorial effort required. 

To sum up: 

(1) Each level of edit consists of a range of effort from minimum to 
maximum, depending on the. condition of the manuscript. 

(2) The condition of the manuscript has a decisive effect on cost and schedule. 

(3) The level of edit defines the quality of the end product but not the effort 
required to achieve it. 




Word About Format and Style 

abf S f inCt '° n betWeen * Format anc 
one or the other type, and also to be able SS C f' t0riaI functions 
precse criterion for distinguishing between Sem 0ne must ^ 

Particularly in those 'areas whew'tbev oTerl ** ^7 etimes difficu,t 10 discen 
because any format guide, in showine e^ni ^ c ° n{usion P^bably ari* 
incorporate some use of mechanical stvle Fn ** ° ** re<,uired ^ ormat > mui 

*- ■ -*■ — taSSSSlS * ,on “ ‘ ni * -a* 


(I) 



- »*• « e 

symbol in its demonstration in order to make' USC * ome kind of sequent 
taken as part of the "requirement " Bv J„ P °‘ l ’ and those symbols may b 
sidered as elements of fomaT * XtenS '° n> ** may «™«>usly be cor 
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A noth -T source of confusion lies in the fact that some uses of mechanical style 
may be manrian»d by the organization while others may be allowed to vary. The 
use of roman numerals for first-order headings may be required by the organiza- 
tion, for example, whereas initial capping of the word “Sun” may be left to the 
discretion of the author or editor. The fact that both these hems are stylistic is 
overshadowed by the fact that one is mandatory and the other is not. From here, 
it is but a small step to the erroneous conclusion that one is format and the other 
is style. 

The distinctions between format and style made here are admittedly arbitrary, 
but we believe that these distinctions, applied rigorously, can clarify much of the 
confusion concerning the difference between the two. 

Format concerns the visual aspect. It answers the question, "What does it look 
like?” The positioning of type on a page, the location of a heading, the size of 
the book itself, the visual image of the type face — its size and shape — are all 
matters of format. Format deals with the aesthetic or design aspects of a publica- 
tion, and format decisions are based primarily on subjective, artistic judgments. 
Whether to use News Gothic or Future, justify or not justify, have two columns 
or one column, put a leading space here or there, center a heading, position a 
page number to the right or left— all of these excisions affect the visual impact of 
the publication. 

Mechanical style, on the other hand, is related to the content of the publica- 
tion. Stylistic decisions are based more on meaning than on form; they deal with 
symbols that represent meaning. Whereas format is concerned with the selection 
of an entire type face (say, Bodoni), for example, mechanical style deals with the 
selection of particular characters (e.g., a boldface capital A to represent a 
vector). The choice of a symbol, a letter, a word, or a phrase is a stylistic choice. 

When a heading in text, or a variable term in a scale label on a graph, is 
written in capital letters, we are talking about format, but when a unit of 
measurement is written in capitals, such as V for volts, we are talking about 
mechanical style. Why is this so? Capitals are capitals, after all. The answer is 
that in the one case we use capitals no matter what letters are involved, while in 
the other case we use capitals only for certain letters, depending on the meaning 
or content of the expression. 

In an effort to illustrate the distinction between style and format, some of the 
areas in which they are often confused are listed in Table 2. 
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TaM* 2. Soma distinctions batwa a n format and atyta 


Area 

Format 

Style 

Headings 

Set in a special type font and/or 
type size 

Centered or flush left 

All caps or initial caps 

On separate line or nin into text 

Marked with roman numeral, 
arabic numeral, decimal 
number, letter, or unmarked 

Listings 

Amount of indention 
Runover lines blocked or indented 
Lines single-spaced or leaded 

Sequence indicated by lowercase 
letters, arabic numerals, or 
lowercase roman numerals 
Periods, single parentheses, or 
double parentheses used with 
sequence symbol 

Page 

Set in a special type font and/or 

Use of lowercase roman 

numbers 

type size 
Position on page 

numerals, atabic numbers, 
or two-part (i.e. , chapter 
and page) numerals 

Figures 

Use of all capitals for callouts as 
a design feature 
Integrated into text, placed on 
separate pages and interleaved, 
grouped at end of chapters, or 
placed at end of report 

Selection of particular symbols, 
words, and phrases in callouts 
to make the style of the call- 
outs consistent with that of 
the text 

Captions 

Set in a special type font and/or 
type size 

Placed above or below figure or 
table 

Blocked or pyramided or shaped 
in some other way 

Justified or unjustified 

Designated as Figure, Fig. . 

Exhibit, Plate. Sketch 
Numbered or unnumbered 
One- or two-part numbers used 

Footnotes 

Set in a special type font and/or 
type size 

Placed at bottom of page or 
grouped at back of report 

Methods of sequencing (by 
chapter or continuously) 
Sequence indicated by arabic 
numbers, letters, or other 
symbols (e.g, asterisks, 
daggers) 

Scale labels 

Positioning of label to be right-reading 

Choice of a particular mark of 

on graphs 

or turned 

Shape of label, such as a variable term, 
followed by a mark of punctuation, 
followed by a unit of measurement 
(e g., DISTANCE, m) 

Variable term written in all caps 

punctuation 

Choice of particular symbols 
for units of measurement 

Math 

Use of em vs piece fractions 
Centering or other positioning of 
equations 

Size of summation, integral, 
parentheses, bracket, and brace signs 
Juxtaposition of inferiors and superiors 

Use of fractional exponents vs 
radical signs 

Use of italics for letter symbols, 
boldface for vectors 
Selective use of solidus vs fraction 
bar 
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VI. The Types of Edit 

The editorial functions that appear in this section ate those that are performed 
by technical editors at the Jet Propulsion Laboratory. JPL editors do not deal 
directly with typesetters, printers, art vendors, and other subcontractors but 
obtain their services through a production department, where technical expertise 
in these areas is concentrated. Production decisions are made by editors only 
from a purely editorial point of view. For this reason, certain production func- 
tions are not included under the types of edit specified here. However, the editors 
are involved in more aspects of the publication process than merely the pure 
editorial function. For instance, they are responsible for budgets, costs, 
schedules, and liaison; in effect, they manage a complete job from start to finish. 
This fact has had a significant effect on the kind of editorial functions included. 

The nine types of edit — Coordination, Policy, Integrity, Screening, Copy 
Clarification, Format, Mechanical Style, Language, and Substantive — are dis- 
cussed below. Because they are combined cumulatively, the edit types are listed 
here in the order of increasing levels (see Table 1). 


A. Coordination Edit 

Coordination Edit consists primarily of manuscript handling and job monitor- 
ing and control. It includes 

(1) Planning and estimating 

(a) Attending planning meetings. 
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(b) Formulating job parameters and specifications. 

(c) Preparing estimates. 

(d) Gathering cost data, such as cost-to-date or cost-tocomplete. 

(2) Record maintenance 

(a) Maintaining records such as status reports, job chronologies, and time 
distribution. 

(b) Verifying the existence of written authorization for any color printing. 

(3) Scheduling and schedule follow-up. 

(4) Manuscript markup 

(a, Marking doorman, number mat gaga numbers on mamnari*. 

(a) Speaifying to publiemion dam the. is to ba primed on to aovar. 

,d) Distinguishing betweo. vandor atom end JPL atonges in onto .o 
determine cost liability. 

(5) Monitoring and liaison 

support groups. 

and the like. 

(C) Holding author checks of edited manuscripts when applicable. 


B. Policy Edit 

A Poliey Edit is applied in to 

of the Jet Propulsion Laboratory. 

A Policy Edit ensures that 

(1) The following required report elements are present, 
(a) Cover and title page 
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(b) Spine (if necessary) 

(c) Credit statement 

(d) Table of contents 


(e) Abstract 

(f ) Half title (where required) 

(g) Page numbers 

(h) Figure captions 


(i) Table titles 

Z) There are at least two first-order headings in the report. 

3) The Table of Contents contains at least the first-order headings and all 

table and figure captions. 

4) References, if any, are complete enough to allow the reader to locate the 
publication referenced. 

5) Internal JPL documents in references are so identified. 

6) International System (SI) units of measurement are used in confoimity 
with directives from NASA (Ref. 1) and JPL. 

(7) No derogatory or otherwise inappropriate judgmental comments are in- 
cluded that would reflect adversely on private companies, government 
agencies, other investigators, or subdivisions within JPL. 

(8) No statements are included that would tend to advertise, endorse, or pro- 
mote the products or services of a company. 

(9) Covers, title pages, credit statements, logos, and front matter conform to 
JPL requirements. 

101 JPL Publications that report NASA research do not contain disclaimers. 


J. Integrity Edit 

An Integrity Edit is concerned primarily with ensuring that the pats of a 
publication match. For example, if “Figure 1“ is cited, an Integrity Edit w> 
letermine whether Figure 1 is included in the report. However, an Integrity Edit 
rill not resolve any apparent inconsistencies or contradictions in the meaning 
ixpressed in different parts of the report. Such discrepancies are discussed m 
Substantive Edit (see Section VI-I). 
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Similarly an Integrity Edit verifies that there are no gaps or repetitions in a 

£> iffoajMW « cued, <* « 

the figures themselves, from 1 through 10. This type of edi . , 

determine that the citations occur in sequential order, the ^ u f n L- 

figures and other numbered elements in a report is a part of Mechanical Style Ed 

(Section VI-G below). 

An Integrity Edit ensures that 

(1) The Table of Contents agrees (in wording and in all djnwtt rf 
( mechanical style) with headings, figure captions, and table tides rathe 

publication. Explanatory material, however, ^ 

and table titles, need not be included in the Table of Contents. 

(2) Page numbers for elements listed in the Table of Contents agree with the 

numbers for those elements in the body of die pubhetemn. 

(3) Each table, figure, reference, footnote, and appendix is cited in the text, 
and each text citation identifies an existing table, figure, reference, foot- 
note, or appendix. 

(4) There are no incorrectly numbered or lettered sequences; i.e., 

fa) No two tables, figures, references, equations, footnotes, sections, 
paragraphs, or subparagraphs have the same number or letter designa- 
tion, and there are no numerical gaps in the sequences. 

(b) Any numbered or lettered sequence is consistent in the kind ofnum- 
’ here or letters used (e.g., roman numerals, arable numbers, hyphen 
ated numbers, decimal numbers). 

(5) No two figure captions or table titles are identical. 

when a reference (citation) is made to another text element (e.g. . section, 

both, that text element actually exists. 

(7) Copy for the spine, if any, is consistent with the information on the cover. 
/a\ Th* invariable elements in a publications series (e.g., publication 

1 ’ -* ■ .t 

volume designuion, cubtilk, ipiue copy) ere expraeod » * 
sistent nurnner throughout all volumes or parts of the senes. 

(9) The dangers of describing the specific content of future 
( (e.g., in the Preface or Foreword) are brought to the author s attention. 

f 101 The subject matter of a current volume in a series agrees with any refe 
(,0> appear in e»l«r volumes; if not, appropriate crea- 

tion is made. 
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(11) References to other publication elements (e.g., other figures or tables) are 
removed from the artwork for slides and viewgraphs with the author’s 
concurrence. 


D. Screening Edit 

A Screening Edit represents the minimum editorial standard that is considered 
acceptable in a JPL external report. Such an edit identifies and corrects aspects of 
the text (e.g., misspelled words) and artwork (e.g., handwritten lettering) that 
are unacceptable. 

A Screening Edit ensures that 

(1) All words are spelled correctly. 

(2) Subjects and verbs agree. 

(3) All sentences are complete. 

(4) Incomprehensible statements, such as those that result from missing 
material, are clarified. 

(5) Figures intended as camera-ready input contain no handwritten or un- 
reproducible lettering. 

(6) Ordinates and abscissas are labeled on graphs. 

(7) Titles are not included within a figure (as they are in a viewgraph). 

(8) Photographs intended as camera-ready input have not already been 
screened. (If the only existing photograph is a halftone, the editor con- 
sults with graphics personnel to determine whether the figure is usable.) 


E. Copy Clarification Edit 

Copy clarification is an editorial process that clarifies illegible material or 
reworks uncomposable text or unproducible artwork in order to give clear 
instructions to keyboarders (including typists and typesetters) and graphics per- 
sonnel. A Copy Clarification Edit includes: 

(1) Clarifying unreadable copy. 

(2) Marking end-of-line hyphens for retention or deletion wherever necessary 
to avoid misinterpretation. 

(3) Deleting unwanted underscores. 
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(4) Indicating table rules. 

(3) Marking mathematics, including 

(a) Identifying and marking symbols and Greek letters as necessary. 

(b) Indicating subscript and superscript positions. 

(c) Indicating acceptable equation breaks. 

(d) Rearranging material to facilitate composition (e.g., using “exp” to 
avoid a cumbersome exponent, turning fractions, etc.) 

(6) Indicating inking requirements on the manuscript, galleys, printouts, and 
facsimile copy. 

(7) Coding text for photocomposition. 

(8) Marking the tops of figures if the orientation is not obvious. 

(9) Indicating crop marks on photographs if the desirable image area is not 
obvious. 

(10) Indicating to graphics personnel the degree to which detail must be pre- 
served in sizing a figure for reduction. 

(11) Obtaining from the author the negative numbers, originals, or previous 
publication numbers in order to re-use figures that have already been 
produced. 

(12) Indicating the parts of a figure to which callouts apply when this informa- 
tion is ambiguous, so that the illustrator may move copy for better fit. 

(13) Miscellaneous marking to indicate special requirements, usually at the 
request of the author, such as specified tick marks or gap indications in 
graphs ( h ) when these requirements are such that analysis or interpreta- 
tion is not required on the part of the editor. 


F. Format Edit 

In a Format Edit, the editor provides instructions for both text and figures to 
ensure conformity with the appropriate format. These instructions include the 
following: 

(I) Typography 

(a) Basic type face specifications, including the use of italics, boldface, 
script, or other special fonts in non-content-related distincttve treat- 
ment for design purposes. 

(b) Leading (spacing) specifications. 


(c) Column width. 

<d) 

' F0n ” “ d ■’° 5i ' i °" «'«"». spi«. and tide pagc copy 

<0 Mi »»*«« fo. P^WPpta, headings, a* ^ 

(g) Mode specification (justified or unjustified). 

<h, irtzrir *■ ■*» «*. «■— heath, 

(2) Layout 

w Sr 

- m “* ws - 

<C ’ -'S’* ***» ^ - fohkwt h gllres 

(3) Figures and visual aids 

" SS' ,ma ‘ e *-*i - minimum ie, K Hn« size 

(b) Position of runover lines in figure callouts. 

(0 Form and position of ordinate and abscissa scale labels 
«) Requirements for skeleton pages or figure sizing lists. 

(e) Position of titles on slides or viewgraphs 

(0 Type and size of slides or viewsranh. /- 

encasing for 35-mm slides; neStive Life. marking: * iass 
requirements). * s dcs or V| ewgraphs; color 

Jt individually^pecified ^^^r°TW? at *“* s,andajdizcd and so are 
many elements of fonnat relating to artv^rk aSS - Wy ‘ rae for Iayout «• for 
for format decisions concerning such iteim a ° ph * S P ersonnel are responsible 
mg fonts, placemen, of douSe ‘22 iZy^; ^ si “ s > 

figures positioning of multi-paitfiguJs. w in ° f 


not 
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symbols, treatment of facsimile copy such as computer printouts, illustration 
sizing, photograph retouching, and others. 

For the most part, these considerations are independent of the context, and so 
are pioperly design (format) considerations. Such elements of format, which are 
not normally of concern to the editor, are not listed here as part of the Format 
Edit. However, the editor may override any standardized format requirement if 
this is necessary to convey the meaning proper 1 ''. 


0. Mechanical Style Edit 

The Mechanical Style Edit is performed to bring the mechanics of the text and 
figures into consistent conformity with a specified style. Such mechanical aspects 
include, for example, capitalization, abbreviations, use of numbers, use of bold 
face and italics for symbols, and sequencing of reference, figure, and table 
citations. 

For JPL Publications, the basic reference for mechanical style is the US. 
Government Printing Office Style Manual (Ref. 2). For other publications (e.g. , 
a journal article or meeting paper), mechanical style will follow whatever guide- 
lines are furnished by the journal, the meeting organizers, or the author. 

Where there are no style guidelines, and with the concurrence of the author, 
the editor may (1) use Ref. 2 or (2) in manuscripts with inconsistent style, 
standardize on the stylistic choices used in the majority of instances. 

The Mechanical Style Edit ensures appropriate and consistent style in the 
following areas: 

(1) Ca pi talizati on related to content (as contrasted with all-caps format in 
headings or figures; e g., “Eanh” vs “earth”). 

(2) Spelling (e.g., “disk” vs “disc”). Note that correct spelling is specified 
in the Screening Edit, but there is no requirement in the Screening L'lit for 
consistency between two acceptable forms. 

(3) Word compounding (e.g., “non-parallel” vs “nonparallel”), including 
treatment of hyphens in unit modifiers (e.g., "solid state” vs “solid- 
state” as unit modifier). 

(4) Form (words vs digits) and construction (nouns vs adjectives) of numerals 
(e.g., level one, level 1, first level). 

(5) Fon t and use of particular symbols, letters, words, or combinations 
thereof, including acronyms and abbreviations (especially units of mea- 
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suiement). Includes the use of alphanumeric or other symbols in headings, 
listings, and paragraphs to indicate sequence and/or subordination. 

(6) Bibliographic reference style, including sequencing of the elements of 
each reference (i.e., author, title, etc.). 

(7) Use of italics, bold face, script, or other special fonts in content- 
related distinctive treatment of particular letters, symbols, or words. 

(8) Sequential appearance of citations and of the elements cited, such as refer- 
ences, equations, figures, tables, footnotes, and appendixes. 

(9) Horizontal spacing between letters, symbols, and words, and around 
mathematical operators (+. =, > , etc.). 

(10) Use of project or organization nomenclature. 

(11) C al 1 ™ 1 ** used to identify curves, data points, ordinates, and abscissas on 
figures. 

(12) Presentation of comparable material from slide to slide or viewgraph to 
viewgraph in a series of visual aids. 


H. Language Edit 

The Language Edit is an in-depth review concerned with the way in which the 
ideas in a report are expressed, regardless of the format (e g., type font) or 
m ^hynical style (e.g., capitalization). The Language Edit may be performed 
separately, without other types of edit. This may happen, for example, in a type 
of editorial assistance offered when an author wishes to have the language 
polished in a manuscript before he submits it to his management for approval. 
The rri it™ - returns the edited manuscript to the author, who arranges to have it 
typed. In this kind of editorial assistance, it is important to remember that the 
pure I anguage Edit does not include marking for mechanical style or for format. 

All editorial changes in a Language Edit are made on the basis of specific and 
i dentifiable reasons rather than the personal preferences of the editor. A 
| ^ngiing f. Edit covers the following areas: 

(1) Spelling, according to Webster's Third New International Dictionary 
(Ref. 3), preferably using the first of any two or more acceptable versions. 

(2) Grammar and syntax. 

(3) Punctuation, according to the U S. Government Printing Office Style 
Manual (Ref. 2). 

(4) Usage, according to the usage level represented by Modern American 
Usage (Ref. 4). 
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(5) Fluency, including transitional words and phrases. 

(6) Language parallelism. Examples of language parallelism ate 

(a) Parallel use of symbols, words, or phrases in listings nr en ume rations 

(b) Parallel wording of headings. 

(c) Parallel breakdown of the skeletal structure (e.g., making sure that if 
there is an (i) subordinate element, there is a parallel (ii) s ubo rdinate 
element). 

(d) Parallel use of grammatical constructions. 

(7) Conciseness. 

(8) Proper use of description, exposition, narrative, and argument and then- 
effect on verb tense. 

(9) Identification of inconsistent or erroneous terminology, to the extent 
possible. 

(10) Definition of abbreviations, acronyms, and symbols. 

(11) Completeness of fences in mathematical expressions. 

(12) In viewgraphs, appropriateness of titles for visual presentation. The editor 
may generate viewgraph titles from publication figure captions. 

Note that there is a fundamental difference between parallelism of language as 
discussed in item (6) above and the concepts of parallelism and subordination 
discussed under Substantive Edit. Parallelism of language is concerned primarily 
with the order and sequencing of symbols, words, and phrases, as distinct from 
the underlying ideas to which they relate. Imagine, for example, two subpara- 
graphs under a main paragraph, with headings such as: 

a. The advantages of gas turbines 

b. Gas turbine disadvantages 

The nonparallelism can be detected without the need to read and nnrUrctanri ^ 
subparagraphs themselves. In contrast, the parallelism and subordination dis- 
cussed under Substantive Edit refer to ideas and concepts, as distinct from the 
words and phrases used to express them. And although substantive parallelism 
should be reflected appropriately in parallel language whenever the lang ua g e can 
be thus used to enhance the u'lderlying similarities or contrasts of ideas, the dis- 
tinction between language parallelism and substantive parallelism should be kept 
cleanly in mind when considering the edit level involved. 

There is also a difference between language parallelism and mechanical style 
with reference to item 6(r ! above. Whether subparagraphs are designated a, b, c; 
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i, ii, iii; or 1 , 2, 3 is a matter of mechanical style; but the appeaiance of i sub- 
paragraph (a) with no subparagraph (b), or (i) with no (ii), is a matter of parallel- 
ism at the language level. And while the detection of such nonparallelisni may be 
accomplished by performing a Language Edit, the repair may well require a 
Substantive Edit of the most probing kind. 

It might seem from a cursory glance at the items above that a i m pay Edit 
consists in using well established, academically approved rules to manipulate a 
piece of prose into a standardized form called clear, objective technical writing, 
indistinguishable from all other instances of technical writing. But we feel that a 
Language Edit goes beyond the mere application of grammatical or syntactical 
rules. We think that an editor should never ignore the spirit of the language, 
should never sacrifice the essence of the communication to a convenient applica- 
tion of prefabricated rules, methods, procedures, or conditions. A Language Edit 
requires a sense of balance, of appropriateness. A heavy-handed editor, for 
instance, in an attempt to eliminate wordiness, may completely excise the 
rhetorical effectiveness of an author’s prose; a timid editor, by allowing inappro- 
priate or unbridled rhetoric, may allow the language to obscure the meaning. 
And i j;< igh rhetoric and literary style are not specifically mentioned here as 
components of a Language Edit, they should, we think, be eve. present in the 
minds of editors. 


I. Substantive Edit 

The Substantive Edit deals with the meaningful content of the publication. T he 
edit includes, but is not limited to, coherence of the individual parts; for 
example, the scope of the publication should be accurately reflected in the Title, 
the Abstract, and the introductory section, and the information in all three areas 
should be consistent. 

It is, of course, impossible to separate substantive thought processes from 
many of the operations that make up the other types of edit. Although other types 
of edit may thus incorporate substantive elements, there is also a wide range of 
editorial operations that are substantive per se and constitute a separate type of 
edit. These operations are discussed below. 


1. Overall Publication 

The editor ensures that the publication contains all of the report elements 
required for a complete presentation of the material, noting gaps, transpositions, 
and redundancies. When it appears necessary to revise the traditional order of 
elements, the editor advises the author on acceptable alternatives. 


Specifically, the editor ensures that 

(1) The Title accurately reflects the content of the publication and is concise 
within the need for qualification. 

(2) The Abstract is concise, is of appropriate length, and presents sufficient 
information to enable the reader to determine the general content of the 
publication. 

(3) The Introduction, the subsequent sections, and the Summary or Conclu- 
sions contain the material indicated by their headings. 

(4) The Appendix material is presented in an acceptable format and is appro- 
priate for inclusion in an appendix. 

(5) The material is grouped and subdivided in a rational manner. 

(6) Parallel ideas are given equal weight, and subordination of ideas is logical 
and appropriate to the content of the publication. (See the discussion of 
language parallelism under Language Edit.) 

(7) The emphasis placed on various elements is appropriate to their signifi- 
cance, and the parallelism and subordination of ideas are appropriately 
reflected in the heading structure. 

(8) Repetition and redundancy are eliminated wherever possible. 

(9) Apparent discrepancies in the meaning expressed in different parts of the 
report are resolved. For example, 

(a) Statements made in different parts of the report do not contradict each 
other, or are not obviously inconsistent. 

(b) The content of a table or figure is not discemibly different from what 
is indicated by the discussion in text. 

(10) Missing material— including factual information as well as required 
elements — is identified and brought to the author's attention. 

(11) Apparently irrelevant or inappropriate material is identified and recom- 
mended for deletion to the author (e.g. . a flowery statement of tribute to a 
contractor). 

( 12) "nie need for a Definition of Symbols or Definition of Abbreviations sec- 
tion is brought to the author's attention, and, if necessary, the editor 
assists the author in preparing such material. 

(13) The need for any additional references in order to document material cited 
from other sources is brought to the author’s attention. 

( 14) The need for obtaining permission to reproduce any copyrighted material 
that may be included is brought to the author’s attention. 
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4. Slides and Vlewgraplw 

The editor analyzes artwork submitted for slides and viewgraphs to ensure that 

(1) The material appropriately represents the subject matter. The editor may 
su ggest to the author other ways of presenting his material. 

(2) The material will be readable when it is presented on a screen. The editor 
ma y suggest deleting copy, rearranging the material, or separating the 
materi al into several slides or viewgraphs. 
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